package io.github.talelin.latticy.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import io.github.talelin.latticy.model.PointsRecordDO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 积分记录Mapper接口
 * @author talelin
 */
@Mapper
public interface PointsRecordMapper extends BaseMapper<PointsRecordDO> {

    /**
     * 根据用户ID分页查询积分记录
     */
    List<PointsRecordDO> selectByUserId(@Param("userId") Long userId, 
                                       @Param("offset") Integer offset, 
                                       @Param("limit") Integer limit);

    /**
     * 根据用户ID和类型分页查询积分记录
     */
    List<PointsRecordDO> selectByUserIdAndType(@Param("userId") Long userId, 
                                              @Param("type") String type,
                                              @Param("offset") Integer offset, 
                                              @Param("limit") Integer limit);

    /**
     * 根据用户ID和来源分页查询积分记录
     */
    List<PointsRecordDO> selectByUserIdAndSource(@Param("userId") Long userId, 
                                                @Param("source") String source,
                                                @Param("offset") Integer offset, 
                                                @Param("limit") Integer limit);

    /**
     * 根据订单ID查询积分记录
     */
    List<PointsRecordDO> selectByOrderId(@Param("orderId") Long orderId);

    /**
     * 查询用户当前积分余额
     */
    Integer selectCurrentBalance(@Param("userId") Long userId);

    /**
     * 统计用户累计获得积分
     */
    Integer sumEarnedPoints(@Param("userId") Long userId);

    /**
     * 统计用户累计使用积分
     */
    Integer sumUsedPoints(@Param("userId") Long userId);

    /**
     * 统计用户累计过期积分
     */
    Integer sumExpiredPoints(@Param("userId") Long userId);

    /**
     * 查询即将过期的积分记录
     */
    List<PointsRecordDO> selectExpiringPoints(@Param("userId") Long userId, 
                                             @Param("now") LocalDateTime now,
                                             @Param("expireDate") LocalDateTime expireDate);

    /**
     * 根据时间范围查询积分记录
     */
    List<PointsRecordDO> selectByDateRange(@Param("userId") Long userId, 
                                          @Param("startDate") LocalDateTime startDate,
                                          @Param("endDate") LocalDateTime endDate,
                                          @Param("offset") Integer offset, 
                                          @Param("limit") Integer limit);
}

